home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat4 / gettydefs.z / gettydefs
Encoding:
Text File  |  2002-10-03  |  8.3 KB  |  199 lines

  1.  
  2.  
  3.  
  4. ggggeeeettttttttyyyyddddeeeeffffssss((((4444))))                                                      ggggeeeettttttttyyyyddddeeeeffffssss((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      gettydefs - speed and terminal settings used by getty
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      The /_e_t_c/_g_e_t_t_y_d_e_f_s file contains information used by _g_e_t_t_y(1M) to set up
  13.      the speed and terminal settings for a line.  It supplies information on
  14.      what the _l_o_g_i_n(1) prompt should look like.  It also supplies the speed to
  15.      try next if the user indicates the current speed is not correct by typing
  16.      a <<<<bbbbrrrreeeeaaaakkkk>>>> character.
  17.  
  18.      NNNNooootttteeee:::: Customers who need to support terminals that pass 8 bits to the
  19.      system (as is typical outside the U.S.) must modify the entries in
  20.      /_e_t_c/_g_e_t_t_y_d_e_f_s as described in the WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS section.
  21.  
  22.      Each entry in /_e_t_c/_g_e_t_t_y_d_e_f_s has the following format:
  23.  
  24.           label# initial-flags # final-flags # login-prompt #next-label
  25.  
  26.      Each entry is followed by a blank line.  The various fields can contain
  27.      quoted characters of the form \\\\bbbb, \\\\nnnn, \\\\cccc, and so on as well as \\\\_n_n_n,
  28.      where _n_n_n is the octal value of the desired character.  The various
  29.      fields are:
  30.  
  31.      _l_a_b_e_l          This is the string against which _g_e_t_t_y tries to match its
  32.                     second argument.  It is often the speed, such as 1111222200000000, at
  33.                     which the terminal is supposed to run, but it need not be
  34.                     (see below).
  35.  
  36.      _i_n_i_t_i_a_l-_f_l_a_g_s  These flags are the initial _i_o_c_t_l(2) settings to which the
  37.                     terminal is to be set if a terminal type is not specified
  38.                     to _g_e_t_t_y.  The flags that _g_e_t_t_y understands are the same
  39.                     as the ones listed in /_u_s_r/_i_n_c_l_u_d_e/_s_y_s/_t_e_r_m_i_o._h (see
  40.                     _t_e_r_m_i_o(7)).  Normally only the speed flag is required in
  41.                     the _i_n_i_t_i_a_l-_f_l_a_g_s.  _g_e_t_t_y automatically sets the terminal
  42.                     to raw input mode and takes care of most of the other
  43.                     flags.  The _i_n_i_t_i_a_l-_f_l_a_g settings remain in effect until
  44.                     _g_e_t_t_y executes _l_o_g_i_n.
  45.  
  46.      _f_i_n_a_l-_f_l_a_g_s    These flags take the same values as the _i_n_i_t_i_a_l-_f_l_a_g_s and
  47.                     are set just before _g_e_t_t_y executes _l_o_g_i_n.  The speed flag
  48.                     is again required.  The composite flag SSSSAAAANNNNEEEE takes care of
  49.                     most of the other flags that need to be set so that the
  50.                     processor and terminal are communicating in a rational
  51.                     fashion.  The other two commonly specified _f_i_n_a_l-_f_l_a_g_s are
  52.                     TTTTAAAABBBB3333, so that tabs are sent to the terminal as spaces, and
  53.                     HHHHUUUUPPPPCCCCLLLL, so that the line is hung up on the final close.
  54.  
  55.      _l_o_g_i_n-_p_r_o_m_p_t   This entire field is printed as the _l_o_g_i_n-_p_r_o_m_p_t.  Unlike
  56.                     the above fields where white space is ignored (a space,
  57.                     tab, or newline), they are included in the _l_o_g_i_n-_p_r_o_m_p_t
  58.                     field.  As a special feature, this field can contain the
  59.                     string $$$$HHHHOOOOSSSSTTTTNNNNAAAAMMMMEEEE, which is replaced by the current
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggeeeettttttttyyyyddddeeeeffffssss((((4444))))                                                      ggggeeeettttttttyyyyddddeeeeffffssss((((4444))))
  71.  
  72.  
  73.  
  74.                     hostname of the machine.  See _h_o_s_t_n_a_m_e(1) for more
  75.                     information.
  76.  
  77.      _n_e_x_t-_l_a_b_e_l     If this entry does not specify the desired speed,
  78.                     indicated by the user typing a <<<<bbbbrrrreeeeaaaakkkk>>>> character, then
  79.                     _g_e_t_t_y searches for the entry with _n_e_x_t-_l_a_b_e_l as its _l_a_b_e_l
  80.                     field and sets up the terminal for those settings.
  81.                     Usually, a series of speeds are linked together in this
  82.                     fashion, into a closed set; for instance, 2222444400000000 linked to
  83.                     1111222200000000, which is linked to 333300000000, which finally is linked to
  84.                     2222444400000000.
  85.  
  86.      If _g_e_t_t_y is called without a second argument, then the first entry of
  87.      /_e_t_c/_g_e_t_t_y_d_e_f_s is used, thus making the first entry of /_e_t_c/_g_e_t_t_y_d_e_f_s the
  88.      default entry.  It is also used if _g_e_t_t_y can not find the specified
  89.      _l_a_b_e_l.  If /_e_t_c/_g_e_t_t_y_d_e_f_s itself is missing, there is one entry built
  90.      into _g_e_t_t_y that brings up a terminal at 333300000000 baud.
  91.  
  92.      It is strongly recommended that after making or modifying /_e_t_c/_g_e_t_t_y_d_e_f_s,
  93.      it be run through _g_e_t_t_y with the check option to be sure there are no
  94.      errors.
  95.  
  96. FFFFIIIILLLLEEEESSSS
  97.      /etc/gettydefs
  98.  
  99. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  100.      getty(1M), login(1), stty(1), ioctl(2), termio(7).
  101.  
  102. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  103.      To support terminals that pass 8 bits to the system (see the BBBBUUUUGGGGSSSS
  104.      section), modify the entries in the /_e_t_c/_g_e_t_t_y_d_e_f_s file for those
  105.      terminals as follows:  add CCCCSSSS8888 to _i_n_i_t_i_a_l-_f_l_a_g_s and replace all
  106.      occurrences of SSSSAAAANNNNEEEE with the values:  BBBBRRRRKKKKIIIINNNNTTTT IIIIGGGGNNNNPPPPAAAARRRR IIIICCCCRRRRNNNNLLLL IIIIXXXXOOOONNNN OOOOPPPPOOOOSSSSTTTT
  107.      OOOONNNNLLLLCCCCRRRR CCCCSSSS8888 IIIISSSSIIIIGGGG IIIICCCCAAAANNNNOOOONNNN EEEECCCCHHHHOOOO EEEECCCCHHHHOOOOKKKK.
  108.  
  109.      An example of changing an entry in /_e_t_c/_g_e_t_t_y_d_e_f_s is illustrated below.
  110.      All the information for an entry must be on one line in the file.
  111.  
  112.      Original entry:
  113.  
  114.           CONSOLE # B9600 HUPCL OPOST ONLCR # B9600 SANE IXANY TAB3
  115.           HUPCL # $HOSTNAME console Login:  # console
  116.  
  117.      Modified entry:
  118.  
  119.           CONSOLE # B9600 CS8 HUPCL OPOST ONLCR # B9600 BRKINT IGNPAR
  120.           ICRNL IXON OPOST ONLCR CS8 ISIG ICANON ECHO ECHOK IXANY
  121.           TAB3 HUPCL # $HOSTNAME console Login:  # console
  122.  
  123.      This change permits terminals to pass 8 bits to the system so long as the
  124.      system is in MULTI-USER state.  When the system changes to SINGLE-USER
  125.      state, the _g_e_t_t_y is killed and the terminal attributes are lost.  So to
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggeeeettttttttyyyyddddeeeeffffssss((((4444))))                                                      ggggeeeettttttttyyyyddddeeeeffffssss((((4444))))
  137.  
  138.  
  139.  
  140.      permit a terminal to pass 8 bits to the system in SINGLE-USER state,
  141.      after you are in SINGLE-USER state, type (see _s_t_t_y(1)):
  142.  
  143.           _ssss_tttt_tttt_yyyy _----_iiii_ssss_tttt_rrrr_iiii_pppp _cccc_ssss_8888
  144.  
  145.  
  146. BBBBUUUUGGGGSSSS
  147.      8-bit with parity mode is not supported.
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.